home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / whatis3.arc / WHAT.DOC < prev    next >
Encoding:
Text File  |  1986-12-24  |  4.8 KB  |  117 lines
  1.  
  2.     WHAT.COM   V1.3  11/21/1985    Written By Kevin Ross
  3.  
  4.  
  5.     HARDWARE: IBM or compatible, running DOS 2.0 or greater.
  6.           Runs on hard or floppy disks. WHAT.DAT must be in root
  7.           directory.
  8.  
  9.     WHAT.COM is written in TURBO-PASCAL 3.0. The source code should be
  10.     distributed with the program.
  11.  
  12.  
  13.         WHAT.COM is a handy little program that keeps little notes about
  14.     files on your system. I am an avid collector of programs, and I download
  15.         alot of files from various BBS's. If you are like me, you have many
  16.         files that you can't remeber downloading, or what they do. That is where
  17.     WHAT.COM comes in handy. When you are finished downloading a program,
  18.     and back at the DOS prompt, you can write a one line description of the
  19.     file. This comes in real handy when you are looking at your hard disk
  20.         directory three months later, and can't remember what CRASH.COM does.
  21.         Thats one of those file names that you don't dare try, without knowing
  22.     exactly what it will do. Using WHAT.COM, you will be able to remind
  23.     yourself with a quick little note.
  24.  
  25.         WHAT.COM is most useful for those with fixed drives, though it
  26.     should work just fine with floppy drives. WHAT.COM creates a file in the
  27.     root directory called WHAT.DAT. This is just a sequential file
  28.     containing the data for the program. Each entry starts in the first
  29.     column with the filename. It must be in uppercase letters. WHAT.COM
  30.     formats the file so it can be printed neatly, with columns for the
  31.     filenames, and descriptions. Descriptions can be up to 60 characters
  32.     long. That should be more than enough for a quick reminder of what a
  33.     program does.
  34.  
  35.     SETTING UP WHAT.COM
  36.     -------------------
  37.  
  38.         First, you should initialize the WHAT.DAT file. This is done by
  39.     giving the command:
  40.                 WHAT OPEN
  41.  
  42.         You will be asked if you want to create the file. If you answer
  43.         'y', a new WHAT.DAT file will be created. If there is already a WHAT.DAT
  44.     file, it will be overwritten, and all the data will be lost. You should
  45.     only use this command once.
  46.  
  47.     (** WARNING: WHAT.DAT SHOULD NOT BE EDITED WITH A TEXT PROCESSER. I HAVE
  48.     TRIED THIS, WITH SEVERAL EDITORS AND IT BECOMES IMPOSSIBLE TO ADD NEW
  49.     DATA TO THE FILE. I SUSPECT IT HAS SOMETHING TO DO WITH THE WAY THE
  50.     TURBO-PASCAL APPEND COMMAND WORKS. I HAVE HAD SUCCESS SORTING THE FILE
  51.     WITH THE DOS SORT FILTER, IF YOU WOULD LIKE TO SORT THE FILE FOR
  52.     PRINTING A HARD COPY. **)
  53.  
  54.         Next, you can start entering your program information. This is
  55.     done by giving the command:
  56.  
  57.                 WHAT NEW filename.ext
  58.  
  59.         You will be asked to enter a 60 character description of the
  60.     file. Enter anything you like. WHAT.COM will automatically include the
  61.         name of the file, so you don't have to re-enter it. (Hint: Enter only
  62.     facts about the program, just enough so you will know what the file
  63.     does, and perhaps how to get help with the program.) When you are done,
  64.         press enter, and WHAT.COM will ask if this is correct. You can enter 'y'
  65.         if it is, and the data will be saved to the file. If you enter 'n',
  66.         WHAT.COM will ask for another description of the file. If you enter 'q',
  67.     WHAT.COM will stop, and the description will be lost.
  68.  
  69.         To find out WHAT a file IS, you enter the command:
  70.  
  71.                 WHAT IS filename.ext
  72.  
  73.         WHAT.COM will then search the DATA file for matching filenames.
  74.     If WHAT.COM finds a filename that matches, it will print the description
  75.     on the screen, then look for another match. If it does not find the
  76.     filename, it will tell you that the file was not found. WHAT searches by
  77.     comparing the characters that were entered at the keyboard, with the
  78.     first characters on each line of the data file. If you enter:
  79.  
  80.                 WHAT IS PROGRAM.COM
  81.  
  82.         WHAT will output the description for PROGRAM.COM.
  83.  
  84.         If you enter:
  85.  
  86.                 WHAT IS PROG
  87.  
  88.         WHAT will output descriptions of all files starting with PROG.
  89.     There might be a PROG.COM, or a PROGA.COM, or PROGRAM.COM. It will match
  90.     the first characters on the data line with the filename. You could
  91.     enter:
  92.                 WHAT IS Q
  93.  
  94.         and all descriptions of files starting with Q would be written
  95.     to the screen.
  96.  
  97.         The last command you can give WHAT.COM is the print command.
  98.     This will send the contents of the WHAT.DAT file to the printer. You
  99.     might find it useful to have a printed copy of WHAT.DAT, in case you
  100.     want to browse through the files.
  101.  
  102.         WHAT.DAT can be sorted with the DOS utility SORT. Best way to
  103.     use it is to give the command:
  104.  
  105.                 SORT < WHAT.DAT >WHAT1.DAT  (then rename WHAT1.DAT to WHAT.DAT)
  106.  
  107.         This will sort the file WHAT.DAT, then save the sorted list back
  108.     in WHAT.DAT. This way, when you print the WHAT.DAT file, it will be in
  109.     some sort of order.
  110.  
  111.  
  112.     NOTICE:
  113.     -------
  114.  
  115.         This program and its source have been released to the public
  116.     domain. No charges are allowed for its distribution or use.
  117.